home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / party / rj_stm02.lha / STread.lha / streader / STread.doc < prev   
Text File  |  1996-02-17  |  10KB  |  250 lines
  1.    _____________________ _____    _____________ __________ _____    ____
  2.    \______    \______   \\_   \  /   /\____.   \\______   \\_   \  /   /
  3.     /   _/    _/    _    \/  _ \/ _  \_____|    \/    _    \/  _ \/ _  \
  4.    /    \      \    Y     \   \  /    \    !     \    Y     \   \  /    \
  5.    \_____\      \_________/____\/_____/__________/__________/____\/_____/
  6.        sct\______/
  7.  
  8.  
  9.                 PRESENTS:
  10.  
  11.  
  12.        SHOWTIME article/adverts reader 1.3 by Randy/Ram Jam
  13.  
  14.  
  15.  
  16. What is & distribution notice:
  17.  
  18. ShowTime is a diskmagazine published by Ram Jam group, with the demo scene as
  19. subject, and it has also the only CHART alive.
  20. This utility is able to display showtime articles to test them, but you have
  21. to edit articles manually with a text editor like cynus ed.
  22. In the current version it is not possible to place any cliparts within
  23. the articles, but this will be done by the coder himself, as it isnt that
  24. hard to include afterwards.
  25. Cliparts must have the max size of 320x180 in Hires and can use 15 colours.
  26. Mark the place, where the cliparts should be included. In this case, consider
  27. that the 15 text colours available will be the ones of clipart, and not the
  28. default ones!!!!
  29. The text print system is based on the original one by MASE/Ram Jam, but is
  30. recoded and enhanced. The "official" suffix for ShowTime files is ".st".
  31. STread is an utility coded especially for Ram Jam members that wants to adjust
  32. the design of articles directly, freeing much time to poor Ram Jam coders that
  33. receive only plain ascii texts to adjust.
  34. But, since many article writers like to design their own articles directly,
  35. I decided to release it also to not RamJammers, but the only use of this
  36. utility must be the design of articles for SHOWTIME.
  37. You can send articles, adverts, clip arts to:
  38.  
  39.          rAM jAM wHQ                   vEGA / rAM jAM
  40.          P.O. bOX 23                   gIUSEPPE gALLUZZO
  41.     I-07040 fERTILIA ( SS )            vIA dEI fRASSINI 6
  42.          I T A L Y                     I-92019 sCIACCA ( aG )
  43.                                            I T A L Y
  44. Or contact me for bug report:
  45.  
  46.     Randy/Ram Jam
  47.     Fabio Ciucci
  48.     Via S.Leonardo, 13
  49.     55100 LUCCA
  50.     ITALY
  51.  
  52.  
  53. Requirements:
  54.  
  55. This utility needs a 68020+ and AGA chipset, like ShowTime, and also the
  56. reqtools.library in libs:
  57.  
  58.  
  59. How to start:
  60.  
  61. Run this utility from cli/shell, and will appear the file requester to select
  62. a showtime (.st) article. If the st format is wrong, the article will be not
  63. load, and error message(s) will be written in the shell window: look at them!
  64. If you quit, you can choose another file to load (or the same updated in
  65. multitasking with an editor), or quit definitely selecting "Cancel" in the
  66. requester.
  67.  
  68.  
  69. Instructions:
  70.  
  71. Ok, now you have read about the Viewer, but how do I write articles or
  72. adverts for Showtime ?
  73. To edit a ShowTime article you must start from a normal ascii text, without
  74. TABS (use spaces instead), and you can choose between two columns of text
  75. or fullpage, I will explain later how to do that.
  76. You can use all characters, including the special ALT+xx ones, like ²³¢¼½°©ð,
  77. except for 16x16 and 24x24 fonts, that have only normal characters.
  78. You can select the colour and the font type/size, but not load the cliparts,
  79. that is easy for me to apply manually, just reserve the space and give me the
  80. clipart (15 colours hires, max 320x180, when colour0 is "transparent").
  81. Also adverts can be tested, the routine is the same, only consider that in
  82. this part (DIARY) the background is blue and the color 02 will FLASH: to
  83. simulate this, press the MAG<->DIARY swap button in the panel.
  84. I added also the option to convert the article to ASCII only and save it.
  85. Keys: Q to Quit, -> and <- to swap pages.
  86.  
  87. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  88.  
  89. Well, the commands are:
  90.  
  91. {               -> To change font and color
  92. }               -> To end text
  93.  
  94. -The } command don't need comments.
  95. -The { command has a special syntax, which must be used to get a pleasant
  96.  result.
  97.  
  98.  {Ncc  -> N=font number, cc=colour 00-07
  99.  
  100. Examples:
  101.  
  102. {100  Font number 1, color 00
  103. {005  Font number 0, color 05
  104.  
  105. These fonts are available:
  106.  
  107. {000  Font num. 0.        8x8 normal
  108. {100  Font num. 1.        8x8 Bold (bold)
  109. {200  Font num. 2.        8x8 fine (fine)
  110. {300  Font num. 3.        16x16 fine (an 8x16 spaced)
  111. {400  Font num. 4.        16x16 full
  112. {500  Font num. 5.        8x8 fine n.2
  113. {600  Font num. 6.        24x24 normal style
  114. {700  Font num. 7.        24x24 style "cowboy"
  115. {800  Font num. 8.        24x24 style "modern"
  116.  
  117. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  118.  
  119. About colors, there are 15 available (range 00-14):
  120.  
  121. {000        Colour 00    White (use this for the main text..)
  122. {001        Colour 01    lighter blu
  123. {002        Colour 02    lighter green  (will flash in diary-adverts part)
  124. {003        Colour 03    yellow
  125. {004        Colour 04    green
  126. {005        Colour 05    blu
  127. {006        Colour 06    gray
  128. {007        Colour 07    pink
  129. {008        Colour 08   lighter white
  130. {009        Colour 09   red
  131. {010        Colour 10    orange
  132. {011        Colour 11    violet
  133. {012        Colour 12    brown
  134. {013        Colour 13    dark pink
  135. {014        Colour 14    red/blu
  136.  
  137.  
  138. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  139.  
  140. Now you know how to use fonts and colours for your text, but
  141. if you still need an example, here is one small text:
  142.  
  143.                                             <- This indicates 38 chars per
  144. -------------------------------------       line, including the "return" !
  145. {304How to paint with {303DPaint {304...
  146.  
  147. {000Ever tried to paint with {003DPaint {000?
  148. Its so easy, just start the progam
  149. and use a brush of your own....  }
  150.  
  151. --------------------------------------
  152. The text will start with a 16x16 charset and a green colour, the
  153. "DPAINT" is highlighted in yellow. Afterwards I changed to the
  154. normal charset (8x8 with colour white) and write most of the text,
  155. just highlighting the "DPaint" again (the questionmark is white
  156. again!!!). The last thing is the closing waved bracket, which indicates
  157. the end of the article.
  158.  
  159. Showtime offers you two modes for your articles/adverts, one or two
  160. columns to be used. If you write articles with 38 chars or less per
  161. line, you will get two columns, but remember that a RETURN on an
  162. editor will also be a character and used in the display, so dont wonder,
  163. if you will get a messy article, if you forget that!
  164. Each column is 38x21, you might check the "design" in order to make the
  165. article more readable and dont cut half of a schedule to another page.
  166.  
  167. The second mode works with 78 chars per line (full page), if you want this
  168. mode in your articles, you must extend the last line of each page
  169. (line 21) with more than 38 chars (if your line does not have that many
  170. chars in there, use SPACEs to make it larger !!!!!!!). You have to repeat
  171. this for every new page.... This sounds annoying, but gives us the
  172. opportunity to mix both styles in one article (for example, you might
  173. use a plain text with 38 chars per line and use a schedule with 78
  174. lines then. Afterwards you continue with the 38 mode and write the rest
  175. of the article.
  176.  
  177. Anyway, if you write an article for SHOWTIME, first write it with your
  178. editor and check, if it does fit into the restrictions and re-edit it
  179. (if it doesnt look good).
  180. The last thing you should do is adding the colours, although that will
  181. virtually scrap the design with the 38 or 78 lines it will work, as the
  182. colour-changing chars wont affect the normal text design at all !!!!
  183.  
  184. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  185. Here is an example of 38/78 columns mode:
  186.  
  187.  
  188. If you write max 38 columns  the  text
  189. will  be draw  in 2 columns, like now!
  190.  
  191.  
  192. Well,  but is also  possible to write  a max of  78 columns,  in full page: to
  193. hevitate the 2 columns routine you have to exceed  the  38th column at the end
  194. of the page, so ShowTime will understand that is not the  case to draw another
  195. column:
  196.  
  197. This is the last line, so EXCEED the 38th column to hevitate the 2nd column!
  198.  
  199.  
  200. Ok, is all for now!  But remember that
  201. spaces placed over the 38th line in  a
  202. 2 column article  can  cause BUGS!! So
  203. check every  time if  there are spaces
  204. over the 38th column!!
  205.  
  206.  
  207. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  208.  
  209. IMPORTANT: There are no ckeckings about overwriting texts, especially for
  210. 16x16 and 24x24 fonts, so BE SURE YOU ARE NOT WRITING OVER THE SCREEN BOTTOM,
  211. or probably Streader will cause a guru meditation.
  212.  
  213. NOTE: There is a bug that I was lazy to fix in time: if you read through the
  214.       text until the last page, everything seems to be fine, but if you then
  215.       switch back pages, sometime the colour of the first lines is
  216.       different to its normal state. This is because the last colour from
  217.       the previous read page is applied to the start of actual page...
  218.       To fix it place a color command {xXX in the first line of every page.
  219.       I think this is not a "bug", if you remember to redefine txt colour
  220.       every start of page, when it is required.
  221.  
  222. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  223.  
  224.  
  225. History:
  226.  
  227. News from 1.0 to 1.1:   Now is possible to use all the 15 colours, instead
  228.             of only 8. The range is 00 - 14.
  229.             On the 8x8 fonts now all the ¹²³¢¼½¾·«»-å°©®þ¤µ¡ø
  230.             characters are usable, so you can use ansi logos
  231.             (especially adverts) with alt+xx characters.
  232.             NOTE: you can't use { } § , because are commands.
  233.             { and } are for text, § is used for cliparts, don't
  234.             insert any § in your texts!!!
  235.  
  236. News from 1.1 to 1.2:   Added a filerequester using reqtools.library.
  237.             So is needed reqtools.library in libs: dir...
  238.  
  239. News from 1.2 to 1.3:   Now there is a font n.5, added a st format checker
  240.             that display errors like "out of color", "out of
  241.             font", "you forgot } at the end"... added the
  242.             mag<->diary background palette swapping, added
  243.             an st->ascii converter.
  244.  
  245.  
  246. Signed: Fashion & Randy/Ram Jam
  247. }
  248.  
  249.  
  250.